home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / c / amigacc68k.lha / cc68k / READ.ME < prev    next >
Encoding:
Text File  |  1994-03-02  |  6.1 KB  |  155 lines
  1. October 1989
  2. ============
  3.  
  4.     I have further modified the compiler to generate symbols and
  5. syntax compatible with Motorola's FREEWARE 68332 assembler;  it is also
  6. compatible with Motorola's 68K family macro assembler as released for
  7. MS-DOS. I used Microsoft Quick C to compile and debug it, and the Quick
  8. C make file (CC68K.MAK) is included.  The original comments of the
  9. author (Matthew Brandt) and the modifier (Ron Fox) are included.
  10.  
  11.     This compiler generates 68000 assembly code, and as such it
  12. doesn't use any of the extra addressing modes or instructions supported
  13. by the 68332. It is meant to be used as a quick and dirty tool to
  14. evaluate Motorola's 68000 microprocessors;  it can be used to generate
  15. production code but I must emphasize that this tool is NOT a supported
  16. product of Motorola Inc.  If you are developing a product and you need a
  17. C compiler for the 68K family, please purchase the official Motorola C
  18. compiler and macro assembler package, since the price is reasonable and
  19. it is supported by Motorola.
  20.  
  21. Scott Howard
  22. Field Applications Engineer
  23. Motorola Semiconductor Products, Canada
  24.  
  25. =======================================================================
  26.  
  27. This archive contains a modified version of Matthew Brandt's C68K
  28. compiler. Where Brandt's compiler generated UNIX assembler code, this
  29. version generates code compatible with MASM, Motorola's resident
  30. Assembler.
  31.   The current version has been revised and quite a few bugs fixed.  It
  32. should be more robust than the previous version. The following is the
  33. copyright notice which appeared in the original version:
  34.  
  35. /*
  36.  *    68000 C compiler
  37.  *
  38.  *    Copyright 1984, 1985, 1986 Matthew Brandt.
  39.  *  all commercial rights reserved.
  40.  *
  41.  *    This compiler is intended as an instructive tool for personal use. Any
  42.  *    use for profit without the written consent of the author is prohibited.
  43.  *
  44.  *    This compiler may be distributed freely for non-commercial use as long
  45.  *    as this notice stays intact. Please forward any enhancements or questions
  46.  *    to:
  47.  *
  48.  *        Matthew Brandt
  49.  *        Box 920337
  50.  *        Norcross, Ga 30092
  51.  */
  52.  
  53.   I performed the original modifications using VMS C, and have therefore
  54. had to edit each module to stick a <> around the stdio.h #include statements.
  55. I have not tested this compiler on an IBM compatible.  Note that the original
  56. documentation for the compiler states that there will be compilation warnings
  57. when building the compiler.  This is still true, due to some mixed mode
  58. int vs pointer assignments.  Take note large memory model users.
  59.  
  60. Bugs/restrictions in the original have not been fixed, these include:
  61. 1. Errors involving char parameters to functions
  62. 2. Limits on the size of functions due to the fact that a function is
  63.    completely parsed before code is generated.
  64. 3. No support for floats, however float declarations do not produce errors.
  65. 4. Preprocessor support is limited to #include and symbol replacement #define
  66.    directives, that is #define's without arguments.
  67. 5. There is no real run time library supplied.  This includes a lack of the
  68.    'standard' useful functions such as printf, scanf and so on.
  69.  
  70. To rebuild:
  71.   Compile all .C files except sieve.c which is a test program.
  72.   Link these together with the run time library of your C compiler.
  73.   Name the output file C68M.  Assemble LIB.SA with the Motorola 68000
  74.   assembler.
  75.  
  76. To use:
  77. Type:
  78.    C68M  file.c
  79.  
  80. Where file.c is the name of the file you want to compile.
  81. The file file.lis and file.sa will be produced. The .lis file is a listing,
  82. and the .sa file is valid assembler input for MASM.  It should be linked
  83. with MLINK and whatever other modules you wish to include.
  84.  
  85. Ron Fox
  86. NSCL
  87. Michigan State University
  88. East Lansing, MI 48824-1321
  89.  
  90. The following is the original READ.ME file for C68K as distributed by
  91. Matthew Brandt, the original author.  Documentation above supersedes the
  92. information in the file below.
  93.  
  94. ----------------------------------- Original READ.ME ----------------------
  95.  
  96.  
  97. NOTICE:
  98.  
  99.     68000 C compiler
  100.  
  101.     Copyright 1984, 1985, 1986 Matthew Brandt.
  102.     all commercial rights reserved.
  103.  
  104.     This compiler is intended as an instructive tool for personal use. Any
  105.     use for profit without the written consent of the author is prohibited.
  106.  
  107.     This compiler may be distributed freely for non-commercial use as long
  108.     as this notice stays intact. Please forward any enhancements or questions
  109.     to:
  110.  
  111.         Matthew Brandt
  112.         Box 920337
  113.         Norcross, Ga 30092
  114.  
  115. This compiler is an optimizing C compiler for the Motorola 68000 processor.
  116. It has successfully compiled itself on UNIX system V running on a Motorola
  117. VME-10. Since this code was written for a machine with long integers it may
  118. exhibit some irregularity when dealing with long integers on the IBM-PC.
  119. The author makes no guarantees. This is not meant as a serious developement
  120. tool although it could, with little work, be made into one. The bugs and
  121. limitations of this compiler are listed below:
  122.  
  123.     -Although you may declare floating point types the code generator does
  124.         not know how to deal with them. They should therefore be avoided.
  125.     
  126.     -The preprocessor does not support arguments to #define'd macros or
  127.         any of #line #ifdef... etc. Only #include and #define are supported.
  128.     
  129.     -Function arguments declared as char may not work properly. Declare
  130.         them as int.
  131.     
  132.     -The size of functions is slightly limited due to the fact that the
  133.         entire function is parsed before any code is generated.
  134.     
  135.     -The output of the compiler is in the UNIX 68000 assembler format.
  136.  
  137. To run the compiler type "cc68 sieve.c". This will compile the program sieve
  138. and produce two files; sieve.lis is a source listing with a symbol type
  139. reference; sieve.s is the 68000 assembly language produced.
  140.  
  141. The file lib.s is the assembly source for some runtime support routines
  142. which must be loaded with the final code. The is no standard runtime library
  143. support.
  144.  
  145. The compiler can be compiled by microsoft C version 3.0 or higher. MSC will
  146. issue lots of warnings but they can be ignored. The file make.bat will
  147. rebuild the compiler if MSC is available.
  148.  
  149. If you wish to make commercial use of all or part of this package please
  150. contact me at the above address or (404)662-0366. Any voluntary contribution
  151. from non-commercial users will be greatly appreciated but is by no means
  152. necessary. enjoy...
  153.                                 Matt Brandt
  154.  
  155.